home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / GRAPHICS / TOOLS / GVIEW / !GView / !Help < prev    next >
Text File  |  1997-05-28  |  10KB  |  214 lines
  1. GView 1.00 (27-May-97)
  2.  
  3. Purpose:     GhostScript frontend
  4. Author:      Martin Würthner
  5. Runs under:  RISC OS 3.1 or higher
  6. Requires:    GhostScript 4.03, ChangeFSI, quite a bit of memory
  7. Status:      FREEWARE (see below)
  8.  
  9. GView is a frontend for GhostScript 4.03 (ported by Michael Dennis-Biemans).
  10. GhostScript is available from http://www.stack.nl/~michaeld/gs.html
  11. GView is useless without GhostScript, so if you do not already have a
  12. working GhostScript setup (including fonts), there is no point in trying to
  13. use GView.
  14.  
  15. GView turns GhostScript into a full Wimp-based PostScript previewer. It extracts
  16. single pages from multi-page PostScript files, processes them using GhostScript
  17. and ChangeFSI and displays the resulting bitmaps.
  18.  
  19. GView offers the following features:
  20. - handles multiple PostScript files simultaneously
  21. - displays each document in a window
  22. - displays the number of pages the document contains in the title bar
  23. - renders documents in monochrome, 16 colours, 256 colours, 32 thousand
  24.   and 16 millon colours (more than 256 colours available only with RISC OS 3.5
  25.   or higher)
  26. - runs in any screen mode
  27.  
  28. It allows you to:
  29. - move to the previous or next page
  30. - jump to any page directly
  31. - save single pages as Sprites
  32. - save all the pages of the whole document as Sprites
  33. - specify the page size and orientation
  34.  
  35. Although the name may suggest a connection with ghostview which is available
  36. for UNIX machines, the connection between GView and ghostview is only in
  37. similar functionality and GView does not borrow any code from ghostview.
  38.  
  39. In order to use a PostScript document with GView, it must obey the Adobe
  40. Structured Documents Convention. Most PostScript files which contain multiple
  41. pages do conform to this convention, e.g. those produced by the RISC OS
  42. PostScript printer driver.
  43.  
  44. Usage
  45. -----
  46.  
  47. On start-up GView checks whether GhostScript and ChangeFSI have already been
  48. seen by the Filer. If not, GView refuses to start. Display a Filer window
  49. for the directories containing GhostScript and ChangeFSI first or make sure
  50. they are *Filer_Booted by your boot sequence.
  51.  
  52. In order to view a PostScript file, drag it to the GView icon on the icon bar
  53. (make sure that is has the correct filetype or GView will reject it). GView
  54. will open a window displaying the first page of the document. If not, please
  55. see below "If things go wrong".
  56.  
  57. The title bar of the window shows the file name and the two numbers [a/b]
  58. where a is the current page number (sequential, not logical) and b is the
  59. total number of pages in the document.
  60.  
  61. You can go to the next or previous page by pressing Page down (or ⇧DOWN) or
  62. Page up (or ⇧UP) respectively.
  63.  
  64. The main menu entry 'Goto' allows you to go to any page immediately by entering
  65. the number in the writable field and pressing Return (or clicking on OK). Note
  66. that again, the number you enter is the sequential (i.e. physical) page number
  67. as opposed to the logical page number that might appear on the page.
  68.  
  69. Other main menu entries are: 'Next page', 'Previous page' (obvious) and 'Save'.
  70. The latter allows you to save the current page only as a Sprite file. If you
  71. want to convert the whole document into a series of Sprites, use 'Document =>
  72. Save' instead (see below). Note that the colour depth of the Sprite is the
  73. one you have chosen in 'Choices...' (from the icon bar menu).
  74.  
  75. The 'Document' sub-menu leads to a document info box ('Info') and two entries:
  76. 'Save' and 'Reprocess'.
  77.  
  78. Whenever a document is first loaded, the current settings in the 'Choices'
  79. dialogue box are taken and are then bound to the window even if the values are
  80. modified later. The 'Reprocess' menu item forces the current values (as entered
  81. in the 'Choices' box) to be read and to replace the values that were in effect
  82. when the window was first opened. So, if you want to change the colour depth of
  83. a window, simply modify the setting in the 'Choices' box and then choose
  84. 'Reprocess'. This causes the current page to be reprocessed with the new
  85. settings. Changing screen mode does not automatically change the colour depth
  86. of open windows (although increasing the colour depth might mean that open
  87. windows are displayed in better quality) unless the colour depth setting was
  88. 'Current' when the document was loaded. In this case, the next page which is
  89. processed after a mode change has the new colour depth.
  90.  
  91. The 'Save' entry in the 'Document' sub-menu is very powerful in that it allows
  92. you to specify a range of (physical) pages to save. Drag the directory icon
  93. to the destination directory and the pages are saved as files 'Page000',
  94. 'Page001', 'Page002 etc. into that directory. This feature is similar to the
  95. one in DVIView where I got this idea from. The colour depth of the generated
  96. sprites is that of the window.
  97.  
  98. Choices
  99. -------
  100.  
  101. In the 'Choices' dialogue box you can specify the default colour depth, paper
  102. size and page orientation to be used for newly loaded documents. If you do not
  103. know the paper size to be used, you can select 'Unspecified'. This will cause
  104. GhostScript to use whatever its default is (might be 'Legal' which is normally
  105. not a good guess or GhostScript might read the paper size from the document).
  106. The best option is usually to set it to A4. You can change the paper size later
  107. by changing it in the 'Choices' box and choose 'Document => Reprocess' from the
  108. document's main menu.
  109.  
  110. Note that a 'Custom' paper size sometimes conflicts with the paper size
  111. specified in the PostScript document. This will cause GhostScript to report
  112. a "configurationerror --setpagedevice-- Additional information: [/PageSize
  113. xxx xxx]". If this happens, simply select 'Unspecified' as paper size and
  114. things should work OK.
  115.  
  116. There are three orientations. 'Portrait' should be obvious. 'Landscape' is the
  117. sort of landscape printing Impression does, i.e. the page is rotated by 90°
  118. anticlockwise. If your document appears the wrong way round with 'Landscape',
  119. try 'Landscape2' which rotates the page in the opposite way. Note that the
  120. 'Widht' and 'Depth' parameters in the paper size group always refer to the
  121. dimensions of the portrait page, so they do not change if you select
  122. 'Landscape'.
  123.  
  124. The 'Colour depth' settings determine the number of colours used for the bitmap
  125. GhostScript is asked to generate. This need not be the same as the colour depth
  126. currently used on screen, however by selecting 'Current' you can force this to
  127. happen.
  128.  
  129. Note that you can speed up the application considerably by choosing a small
  130. colour depth. For most documents (manuals etc.), monochrome should be enough.
  131. This also reduces memory usage.
  132.  
  133. If things go wrong
  134. ------------------
  135.  
  136. GView has a very rudimentary error handling. Basically, it simply calls
  137. GhostScript and if the requested output file exists after the call has
  138. returned, GView assumes that everything was OK and passes it to ChangeFSI.
  139. After the call to ChangeFSI has returned, GView reads the generated Sprite
  140. file. If either GhostScript or ChangeFSI report an error, then it is likely
  141. that there was something wrong with the PostScript file. Errors reported by
  142. GhostScript are displayed in an error box.
  143.  
  144. Check whether you have enough space in !Scrap. This is particularly important
  145. if you have chosen 32 thousand or 16 million colours as in this case GView will
  146. ask GhostScript to generate a 24bpp representation of the image which can take
  147. lots of disc space. In addition to the .PCX (or .PPM) generated, there must be
  148. enough space for the Sprite generated by ChangeFSI. To render an A4 page at
  149. 16 million colours, you need about 11M of free disc space!
  150.  
  151. If the PostScript file contains the paper size, then GhostScript will report
  152. an error if you specify a differing 'Custom' paper size. In case of doubt
  153. select 'Unspecified'.
  154.  
  155. Memory can be a problem, too. The Obey files !GS and !CFSI inside !GView are
  156. used to call GhostScript and ChangeFSI respectively. If either GhostScript or
  157. ChangeFSI complain because of a lack of memory, then try increasing the slots
  158. given to them in these files. Note that they run one after another, so you need
  159. only the maximum of both values as free memory, not the sum. When modifying
  160. the *Wimpslot commands in !GS and !CFSI make sure you do not change anything
  161. else! Take a backup copy of the original files before modifying them.
  162.  
  163. Please do not contact me if you have problems setting up GhostScript in the
  164. first place. As said above, there is no point in using GView unless GhostScript
  165. works already. If GView fails, try rendering the document using the GhostScript
  166. command line. If that works, then there is a GView problem and I will be happy
  167. to solve it. However, if the command-line driven GhostScript fails as well,
  168. then you have a problem with your GhostScript setup.
  169.  
  170. Credits
  171. -------
  172. Many thanks to Dominik Symes for Zap, to Paul Fields for DVIView from which I
  173. got several good ideas for this application, to Michael Dennis-Biemans for
  174. porting GhostScript 4.03, to David Alstein for TemplEd, to Acorn Computers
  175. for the DrawFile module which is used by GView.
  176.  
  177. Acknowledgements
  178. ----------------
  179. PostScript is a trademark of Adobe Systems Inc.
  180. UNIX is a trademark of AT&T.
  181. The DrawFile module used by this application is © Acorn Computers Ltd.
  182.  
  183. Copyright message
  184. -----------------
  185. This application, GView, is © Martin Würthner, 1997 and is FREEWARE.
  186. This means that you may copy it freely provided that
  187. (a) all files of this application are distributed together without
  188.     modification
  189. (b) this application is not sold for profit without my explicit written
  190.     permission (this includes distribution on CD)
  191.  
  192. You can contact me at:
  193.  
  194. Martin Würthner
  195. Jahnstraße 18
  196. 71116 Gärtringen
  197. Germany
  198.  
  199. Phone: +49-7034-928986
  200. Fax:   +49-7034-928915
  201.  
  202. e-mail: wuerthne@trick.informatik.uni-stuttgart.de
  203.  
  204. If you find this application useful, what about sending me a small bag of
  205. crisps to show your ackowledgement of the work I have put into this
  206. application? I am very fond of British crisps... If it is Christmas time, a
  207. small Christmas pudding would be welcome as well. Or at Easter, a Cadbury's
  208. Caramel Egg. Or a pack of Coconut Cream Crunch biscuits. You see, the
  209. possibilities are almost endless...
  210.  
  211. If you find this application completely useless, bug-ridden and disgusting,
  212. then it is quite enough to tell me. There is no need to send me any British
  213. sausages... :-)
  214.